home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglteximage3d.z / fglteximage3d
Encoding:
Text File  |  2001-04-17  |  49.6 KB  |  535 lines
  1.  
  2.  
  3.  
  4. ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD - specify a three-dimensional texture image
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD( INTEGER*4 _t_a_r_g_e_t,
  14.                                INTEGER*4 _l_e_v_e_l,
  15.                                INTEGER*4 _i_n_t_e_r_n_a_l_f_o_r_m_a_t,
  16.                                INTEGER*4 _w_i_d_t_h,
  17.                                INTEGER*4 _h_e_i_g_h_t,
  18.                                INTEGER*4 _d_e_p_t_h,
  19.                                INTEGER*4 _b_o_r_d_e_r,
  20.                                INTEGER*4 _f_o_r_m_a_t,
  21.                                INTEGER*4 _t_y_p_e,
  22.                                CHARACTER*8 _p_i_x_e_l_s )
  23.  
  24.  
  25. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  26.      _t_a_r_g_e_t          Specifies the target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD or
  27.                      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD.
  28.  
  29.      _l_e_v_e_l           Specifies the level-of-detail number.  Level 0 is the
  30.                                                         th
  31.                      base image level.  Level n is the n   mipmap reduction
  32.                      image.
  33.  
  34.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t  Specifies the number of color components in the texture.
  35.                      Must be 1, 2, 3, or 4, or one of the following symbolic
  36.                      constants:  GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____AAAALLLLPPPPHHHHAAAA8888, GGGGLLLL____AAAALLLLPPPPHHHHAAAA11112222,
  37.                      GGGGLLLL____AAAALLLLPPPPHHHHAAAA11116666, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888,
  38.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA,
  39.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE6666____AAAALLLLPPPPHHHHAAAA2222,
  40.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____AAAALLLLPPPPHHHHAAAA8888, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA4444,
  41.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____AAAALLLLPPPPHHHHAAAA11116666,
  42.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY4444, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY8888,
  43.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11112222, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11116666, GGGGLLLL____RRRR3333____GGGG3333____BBBB2222, GGGGLLLL____RRRRGGGGBBBB,
  44.                      GGGGLLLL____RRRRGGGGBBBB4444, GGGGLLLL____RRRRGGGGBBBB5555, GGGGLLLL____RRRRGGGGBBBB8888, GGGGLLLL____RRRRGGGGBBBB11110000, GGGGLLLL____RRRRGGGGBBBB11112222, GGGGLLLL____RRRRGGGGBBBB11116666,
  45.                      GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____RRRRGGGGBBBBAAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA4444, GGGGLLLL____RRRRGGGGBBBB5555____AAAA1111, GGGGLLLL____RRRRGGGGBBBBAAAA8888,
  46.                      GGGGLLLL____RRRRGGGGBBBB11110000____AAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA11112222, or GGGGLLLL____RRRRGGGGBBBBAAAA11116666.
  47.  
  48.      _w_i_d_t_h           Specifies the width of the texture image.  Must be
  49.                       n
  50.                      2  + 2(border) for some integer n. All implementations
  51.                      support texture images that are at least 64 texels wide.
  52.  
  53.      _h_e_i_g_h_t          Specifies the height of the texture image.  Must be
  54.                       m
  55.                      2  + 2(border) for some integer m. All implementations
  56.                      support texture images that are at least 64 texels high.
  57.  
  58.      _d_e_p_t_h           Specifies the depth of the texture image.  Must be
  59.                       k
  60.                      2  + 2(border) for some integer k. All implementations
  61.                      support texture images that are at least 64 texels deep.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                                                         PPPPaaaaggggeeee 1111
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74. ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  75.  
  76.  
  77.  
  78.      _b_o_r_d_e_r          Specifies the width of the border.  Must be either 0 or
  79.                      1.
  80.  
  81.      _f_o_r_m_a_t          Specifies the format of the pixel data.  The following
  82.                      symbolic values are accepted:  GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX, GGGGLLLL____RRRREEEEDDDD,
  83.                      GGGGLLLL____GGGGRRRREEEEEEEENNNN, GGGGLLLL____BBBBLLLLUUUUEEEE, GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____RRRRGGGGBBBB, GGGGLLLL____BBBBGGGGRRRR, GGGGLLLL____RRRRGGGGBBBBAAAA,
  84.                      GGGGLLLL____BBBBGGGGRRRRAAAA, GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, and
  85.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA.
  86.  
  87.      _t_y_p_e            Specifies the data type of the pixel data.  The following
  88.                      symbolic values are accepted:  GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____BBBBYYYYTTTTEEEE,
  89.                      GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT,
  90.                      GGGGLLLL____IIIINNNNTTTT, GGGGLLLL____FFFFLLLLOOOOAAAATTTT GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222,
  91.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555,
  92.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444,
  93.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111,
  94.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888,
  95.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222,
  96.                      and GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV.
  97.  
  98.      _p_i_x_e_l_s          Specifies a pointer to the image data in memory.
  99.  
  100. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  101.      Texturing maps a portion of a specified texture image onto each graphical
  102.      primitive for which texturing is enabled.  To enable and disable three-
  103.      dimensional texturing, call ffffggggllllEEEEnnnnaaaabbbblllleeee and ffffggggllllDDDDiiiissssaaaabbbblllleeee with argument
  104.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD.
  105.  
  106.      To define texture images, call ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD. The arguments describe the
  107.      parameters of the texture image, such as height, width, depth, width of
  108.      the border, level-of-detail number (see ffffggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr), and number of
  109.      color components provided.  The last three arguments describe how the
  110.      image is represented in memory; they are identical to the pixel formats
  111.      used for ffffggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss.
  112.  
  113.      If _t_a_r_g_e_t is GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD, no data is read from _p_i_x_e_l_s, but all of
  114.      the texture image state is recalculated, checked for consistency, and
  115.      checked against the implementation's capabilities. If the implementation
  116.      cannot handle a texture of the requested texture size, it sets all of the
  117.      image state to 0, but does not generate an error (see ffffggggllllGGGGeeeettttEEEErrrrrrrroooorrrr). To
  118.      query for an entire mipmap array, use an image array level greater than
  119.      or equal to 1.
  120.  
  121.      If _t_a_r_g_e_t is GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD, data is read from _p_i_x_e_l_s as a sequence of
  122.      signed or unsigned bytes, shorts, or longs, or single-precision
  123.      floating-point values, depending on _t_y_p_e. These values are grouped into
  124.      sets of one, two, three, or four values, depending on _f_o_r_m_a_t, to form
  125.      elements. If _t_y_p_e is GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP, the data is considered as a string of
  126.      unsigned bytes (and _f_o_r_m_a_t must be GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX). Each data byte is
  127.      treated as eight 1-bit elements, with bit ordering determined by
  128.      GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT (see ffffggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee).
  129.  
  130.  
  131.  
  132.  
  133.                                                                         PPPPaaaaggggeeee 2222
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140. ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  141.  
  142.  
  143.  
  144.      The first element corresponds to the lower left corner of the texture
  145.      image.  Subsequent elements progress left-to-right through the remaining
  146.      texels in the lowest row of the texture image, and then in successively
  147.      higher rows of the texture image.  The final element corresponds to the
  148.      upper right corner of the texture image.
  149.  
  150.      _f_o_r_m_a_t determines the composition of each element in _p_i_x_e_l_s.  It can
  151.      assume one of eleven symbolic values:
  152.  
  153.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX
  154.                Each element is a single value, a color index. The GL converts
  155.                it to fixed point (with an unspecified number of zero bits to
  156.                the right of the binary point), shifted left or right depending
  157.                on the value and sign of GGGGLLLL____IIIINNNNDDDDEEEEXXXX____SSSSHHHHIIIIFFFFTTTT, and added to
  158.                GGGGLLLL____IIIINNNNDDDDEEEEXXXX____OOOOFFFFFFFFSSSSEEEETTTT (see ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr). The resulting index is
  159.                converted to a set of color components using the
  160.                GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB,
  161.                and GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA tables, and clamped to the range [0,1].
  162.  
  163.      GGGGLLLL____RRRREEEEDDDD    Each element is a single red component. The GL converts it to
  164.                floating point and assembles it into an RGBA element by
  165.                attaching 0 for green and blue, and 1 for alpha. Each component
  166.                is then multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added
  167.                to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1]
  168.                (see ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  169.  
  170.      GGGGLLLL____GGGGRRRREEEEEEEENNNN  Each element is a single green component. The GL converts it to
  171.                floating point and assembles it into an RGBA element by
  172.                attaching 0 for red and blue, and 1 for alpha. Each component
  173.                is then multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added
  174.                to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1]
  175.                (see ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  176.  
  177.      GGGGLLLL____BBBBLLLLUUUUEEEE   Each element is a single blue component. The GL converts it to
  178.                floating point and assembles it into an RGBA element by
  179.                attaching 0 for red and green, and 1 for alpha. Each component
  180.                is then multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added
  181.                to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1]
  182.                (see ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  183.  
  184.      GGGGLLLL____AAAALLLLPPPPHHHHAAAA  Each element is a single alpha component. The GL converts it to
  185.                floating point and assembles it into an RGBA element by
  186.                attaching 0 for red, green, and blue.  Each component is then
  187.                multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the
  188.                signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1] (see
  189.                ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  190.  
  191.      GGGGLLLL____RRRRGGGGBBBB
  192.  
  193.      GGGGLLLL____BBBBGGGGRRRR    Each element is an RGB triple.  The GL converts it to floating
  194.                point and assembles it into an RGBA element by attaching 1 for
  195.                alpha.  Each component is then multiplied by the signed scale
  196.  
  197.  
  198.  
  199.                                                                         PPPPaaaaggggeeee 3333
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206. ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  207.  
  208.  
  209.  
  210.                factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and
  211.                clamped to the range [0,1] (see ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  212.  
  213.      GGGGLLLL____RRRRGGGGBBBBAAAA
  214.  
  215.      GGGGLLLL____BBBBGGGGRRRRAAAA
  216.  
  217.      GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT
  218.                Each element contains all four components.  Each component is
  219.                multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the
  220.                signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1] (see
  221.                ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  222.  
  223.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE
  224.                Each element is a single luminance value.  The GL converts it
  225.                to floating point, then assembles it into an RGBA element by
  226.                replicating the luminance value three times for red, green, and
  227.                blue and attaching 1 for alpha. Each component is then
  228.                multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the
  229.                signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1] (see
  230.                ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  231.  
  232.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA
  233.                Each element is a luminance/alpha pair.  The GL converts it to
  234.                floating point, then assembles it into an RGBA element by
  235.                replicating the luminance value three times for red, green, and
  236.                blue.  Each component is then multiplied by the signed scale
  237.                factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and
  238.                clamped to the range [0,1] (see ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  239.  
  240.      Refer to the ffffggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss reference page for a description of the
  241.      acceptable values for the _t_y_p_e parameter.
  242.  
  243.      If an application wants to store the texture at a certain resolution or
  244.      in a certain format, it can request the resolution and format with
  245.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t. The GL will choose an internal representation that
  246.      closely approximates that requested by _i_n_t_e_r_n_a_l_f_o_r_m_a_t, but it may not
  247.      match exactly.  (The representations specified by GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE,
  248.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____RRRRGGGGBBBB, and GGGGLLLL____RRRRGGGGBBBBAAAA must match exactly. The numeric
  249.      values 1, 2, 3, and 4 may also be used to specify the above
  250.      representations.)
  251.  
  252.      Use the GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD target to try out a resolution and format.
  253.      The implementation will update and recompute its best match for the
  254.      requested storage resolution and format. To then query this state, call
  255.      ffffggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr.  If the texture cannot be accommodated, texture
  256.      state is set to 0.
  257.  
  258.      A one-component texture image uses only the red component of the RGBA
  259.      color extracted from _p_i_x_e_l_s. A two-component image uses the R and A
  260.      values.  A three-component image uses the R, G, and B values.  A four-
  261.      component image uses all of the RGBA components.
  262.  
  263.  
  264.  
  265.                                                                         PPPPaaaaggggeeee 4444
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272. ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  273.  
  274.  
  275.  
  276.      Normally ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD is synchronous: OpenGL executes a ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD
  277.      command in the order it is issued in the OpenGL command stream.  Calling
  278.      ffffggggllllEEEEnnnnaaaabbbblllleeee with parameter GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX causes subsequent
  279.      ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD commands to be asynchronous as defined by the SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc
  280.      extension.  An asynchronous ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD command samples the OpenGL
  281.      state vector at the point in the OpenGL command stream where the command
  282.      is issued, but the results of the command (e.g. availability of texels
  283.      for use in rasterization) do not happen until some unspecified time in
  284.      the future.  In particular, the order of the asynchronous command
  285.      relative to other OpenGL commands issued later in the command stream is
  286.      undefined.  An implementation may choose to execute asynchronous commands
  287.      in parallel with the normal command stream or at some convenient time in
  288.      the future.
  289.  
  290.      Calling ffffggggllllDDDDiiiissssaaaabbbblllleeee with parameter GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX restores the
  291.      default synchronous behavior for subsequent ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD commands.  It
  292.      does not affect any pending asynchronous ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee commands, or wait
  293.      for their completion.
  294.  
  295.      When an asynchronous ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD command is issued, it is associated
  296.      with the current value of GGGGLLLL____AAAASSSSYYYYNNNNCCCC____MMMMAAAARRRRKKKKEEEERRRR____SSSSGGGGIIIIXXXX as defined by the
  297.      SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc extension.  A program can determine if an asynchronous
  298.      ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD command has completed by using the ffffggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX or
  299.      ffffggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX commands.
  300.  
  301.      There is a maximum number of asynchronous ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee commands that can
  302.      be outstanding at any one time, defined by the implementation.  This
  303.      value can be queried with ffffggggllllGGGGeeeettttIIIInnnntttteeeeggggeeeerrrrvvvv with argument
  304.      GGGGLLLL____MMMMAAAAXXXX____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX.
  305.  
  306. NNNNOOOOTTTTEEEESSSS
  307.      Texturing has no effect in color index mode.
  308.  
  309.      The texture image can be represented by the same data formats as the
  310.      pixels in a ffffggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss command, except that GGGGLLLL____SSSSTTTTEEEENNNNCCCCIIIILLLL____IIIINNNNDDDDEEEEXXXX and
  311.      GGGGLLLL____DDDDEEEEPPPPTTTTHHHH____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT cannot be used.  ffffggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee and ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr
  312.      modes affect texture images in exactly the way they affect ffffggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss.
  313.  
  314.      GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT is part of the EEEEXXXXTTTT____aaaabbbbggggrrrr extension, not part of the core GL
  315.      command set.  If GGGGLLLL____EEEEXXXXTTTT____aaaabbbbggggrrrr is included in the string returned by
  316.      ffffggggllllGGGGeeeettttSSSSttttrrrriiiinnnngggg, when called with argument GGGGLLLL____EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS, extension EEEEXXXXTTTT____aaaabbbbggggrrrr
  317.      is supported by the GL.
  318.  
  319.      ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD is available only if the GL version is 1.2 or greater.
  320.  
  321.      Internal formats other than 1, 2, 3, or 4 may be used only if the GL
  322.      version is 1.1 or greater.
  323.  
  324.      _p_i_x_e_l_s may be a null pointer. In this case texture memory is allocated to
  325.      accommodate a texture of width _w_i_d_t_h, height _h_e_i_g_h_t, and depth _d_e_p_t_h.
  326.      You can then download subtextures to initialize this texture memory. The
  327.      image is undefined if the user tries to apply an uninitialized portion of
  328.  
  329.  
  330.  
  331.                                                                         PPPPaaaaggggeeee 5555
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  339.  
  340.  
  341.  
  342.      the texture image to a primitive.
  343.  
  344.      Formats GGGGLLLL____BBBBGGGGRRRR, and GGGGLLLL____BBBBGGGGRRRRAAAA and types GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222,
  345.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555,
  346.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444,
  347.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111,
  348.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888,
  349.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, and
  350.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV are available only if the GL version is
  351.      1.2 or greater.
  352.  
  353.      If the GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg extension is supported, RGBA elements may also be
  354.      processed by the imaging pipeline.  The following stages may be applied
  355.      to an RGBA color before color component clamping to the range [0, 1]:
  356.  
  357.      1. Color component replacement by the color table specified for
  358.         GGGGLLLL____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, if enabled. See ffffggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee.
  359.  
  360.      2. Color component replacement by the color table specified for
  361.         GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, if enabled.  See ffffggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee.
  362.  
  363.      3. Transformation by the color matrix.  See ffffggggllllMMMMaaaattttrrrriiiixxxxMMMMooooddddeeee.
  364.  
  365.      4. RGBA components may be multiplied by GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____cccc____SSSSCCCCAAAALLLLEEEE,
  366.         and added to GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____cccc____BBBBIIIIAAAASSSS, if enabled.  See
  367.         ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr.
  368.  
  369.      5. Color component replacement by the color table specified for
  370.         GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, if enabled.  See ffffggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee.
  371.  
  372. EEEERRRRRRRROOOORRRRSSSS
  373.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD or
  374.      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD.
  375.  
  376.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _f_o_r_m_a_t is not an accepted format
  377.      constant.  Format constants other than GGGGLLLL____SSSSTTTTEEEENNNNCCCCIIIILLLL____IIIINNNNDDDDEEEEXXXX and
  378.      GGGGLLLL____DDDDEEEEPPPPTTTTHHHH____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT are accepted.
  379.  
  380.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is not a type constant.
  381.  
  382.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP and _f_o_r_m_a_t is not
  383.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX.
  384.  
  385.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than 0.
  386.  
  387.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE may be generated if _l_e_v_e_l is greater than log _m_a_x, where
  388.                                                                    2
  389.      _m_a_x is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
  390.  
  391.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _i_n_t_e_r_n_a_l_f_o_r_m_a_t is not 1, 2, 3, 4, or one
  392.      of the accepted resolution and format symbolic constants.
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                                                                         PPPPaaaaggggeeee 6666
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405. ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  406.  
  407.  
  408.  
  409.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h, _h_e_i_g_h_t, or _d_e_p_t_h is less than 0
  410.      or greater than 2 + GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE, or if either cannot be
  411.                      k
  412.      represented as 2  + 2(border) for some integer value of _k.
  413.  
  414.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _b_o_r_d_e_r is not 0 or 1.
  415.  
  416.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD is executed between
  417.      the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ffffggggllllEEEEnnnndddd.
  418.  
  419.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if _t_y_p_e is one of
  420.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV,
  421.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV and _f_o_r_m_a_t is not
  422.      GGGGLLLL____RRRRGGGGBBBB.
  423.  
  424.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if _t_y_p_e is one of
  425.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV,
  426.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV,
  427.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV,
  428.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV and _f_o_r_m_a_t
  429.      is not GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____BBBBGGGGRRRRAAAA or GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT.
  430.  
  431.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX is enabled
  432.      and the number of asynchronous ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee commands that have been issued
  433.      but not queried (using ffffggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX or ffffggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX) exceeds
  434.      GGGGLLLL____MMMMAAAAXXXX____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX.
  435.  
  436. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  437.      ffffggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee
  438.      ffffggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD
  439.  
  440.  
  441. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  442.      The SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc and SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc____ppppiiiixxxxeeeellll extensions are implemented only on
  443.      Octane2 VPro systems.
  444.  
  445.      On RealityEngine, RealityEngine2, and VTX systems, the following
  446.      restrictions apply to 3D texturing:
  447.  
  448.           1.  The texture environment must be defined and texturing must be
  449.               enabled before loading a texture.
  450.  
  451.           2.  Texture formats composed only of alpha are not supported.
  452.  
  453.           3.  Borders are not supported; hence the border width must be 0.
  454.  
  455.           4.  Proxy textures are not supported.
  456.  
  457.           5.  3D mipmaps are not supported. Hence, the minifying function must
  458.               be set to GGGGLLLL____NNNNEEEEAAAARRRREEEESSSSTTTT or GGGGLLLL____LLLLIIIINNNNEEEEAAAARRRR (see ffffggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr).
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                                                                         PPPPaaaaggggeeee 7777
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472. ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  473.  
  474.  
  475.  
  476.           6   3D texturing when rendering to pixmaps is not supported.
  477.  
  478.           7.  GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX is not supported (see ffffggggllllEEEEnnnnaaaabbbblllleeee).
  479.  
  480.      On High Impact and Maximum Impact systems, the following restrictions
  481.      apply to 3D texturing:
  482.  
  483.           1.  Perspective views are not supported.
  484.  
  485.           2.  Borders are not supported; hence the border width must be 0.
  486.  
  487.           3.  3D mipmaps are not supported. Hence, the minifying function must
  488.               be set to GGGGLLLL____NNNNEEEEAAAARRRREEEESSSSTTTT or GGGGLLLL____LLLLIIIINNNNEEEEAAAARRRR (see ffffggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr), and the
  489.               level parameter must be 0.
  490.  
  491.           4.  Textures that have a width of 16 or less will not render
  492.               correctly at the wrap_s boundary.
  493.      On Octane2 VPro systems, 3D mipmapping is not supported.  However, all
  494.      OpenGL state related to the GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD target is correctly error-
  495.      checked and queryable.  For example, an incomplete mipmap stack results
  496.      in disabling 3D texturing, just as if 3D mipmapping were supported.  The
  497.      only restriction is that, during rasterization, only the base level of
  498.      the texture is sampled.  (The GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBAAAASSSSEEEE____LLLLEEEEVVVVEEEELLLL parameter may be used
  499.      to establish the base level of the texture; it need not be level 0.)  For
  500.      3D texturing at rasterization time, the mipmapping forms of the
  501.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____MMMMIIIINNNN____FFFFIIIILLLLTTTTEEEERRRR parameter are synonymous with the equivalent non-
  502.      mipmapping form.
  503.  
  504.  
  505. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  506.      ffffggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD,
  507.      ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD,
  508.      ffffggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ffffggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee, ffffggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr, ffffggggllllTTTTeeeexxxxEEEEnnnnvvvv, ffffggggllllTTTTeeeexxxxGGGGeeeennnn,
  509.      ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ffffggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ffffggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD,
  510.      ffffggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ffffggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr, ffffggggllllAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrSSSSGGGGIIIIXXXX,
  511.      ffffggggllllDDDDeeeelllleeeetttteeeeAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrssssSSSSGGGGIIIIXXXX, ffffggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX, ffffggggllllGGGGeeeennnnAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrssssSSSSGGGGIIIIXXXX,
  512.      ffffggggllllIIIIssssAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrSSSSGGGGIIIIXXXX, ffffggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                                                                         PPPPaaaaggggeeee 8888
  532.  
  533.  
  534.  
  535.